home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 June / Macworld (1998-06).dmg / Shareware World / Utilities / User Interface / Snap-To / Snap-To ReadMe < prev   
Text File  |  1998-04-09  |  7KB  |  104 lines

  1. Snap-To 2.1.2 ReadMe
  2.  
  3. © 1993-98 by Eden Sherry
  4.  
  5. eden@kagi.com
  6. www.edenware.com
  7.  
  8. • What It Does
  9.  
  10. Snap-To is a control panel that snaps the cursor to the default button whenever a dialog comes up on your screen. Fairly simple, but it’ll increase your speed when using a Macintosh, especially if you use dialogs often and/or have a large screen.
  11.  
  12. Snap-To can also do some other neat things, like snap the cursor back to its original location after you close a dialog box, or automatically disable itself in Open or Save dialogs. It can also “glide” the cursor to the default button instead of abruptly snapping it there.
  13.  
  14. • Shareware!
  15.  
  16. Snap-To is shareware, and a measly five bucks at that. If you use it, please consider registering, as it makes me happy when people give me money. You can either register with the enclosed Register application, or go to <http://order.kagi.com/?1UE> to register online with a credit card. (Quick 'n' easy!)
  17.  
  18. • Where’s Trev?
  19.  
  20. Early versions of Snap-To were released under the name Trevden Sherzell, which is, in fact, a pen name. I’ve decided that it causes more trouble than it’s worth, and so chose to give it up before it became too late.
  21.  
  22. If you’re concerned that I’m some evil person trying to take over Trev’s neat control panel, note the subtle similarity between Trevden Sherzell and Eden Sherry, my real name. In addition, the person at trevden@aol.com, the old address, will happily tell you that his real name is actually Eden. (Someone on AOL took eden@aol.com a long time ago.)
  23.  
  24. • System Requirements
  25.  
  26. Snap-To 2.1 will run on any Mac running System 7 or later. If, for some bizarre reason, you’re still running System 6, Snap-To 2.0 is compatible with System 6.0.4 and later. If you can’t find a copy of 2.0 and need it, send me mail.
  27.  
  28. • Installation
  29.  
  30. To install Snap-To, simply drop it onto your System Folder.
  31.  
  32. If you are upgrading from Snap-To 1.0, and are using System 7, you also must first remove the old file “Snap-To” from your Extensions folder within your System Folder. (If anyone’s actually upgrading from Snap-To 1.0, I’d be very surprised. Send me mail. :)
  33.  
  34. • Version History
  35.  
  36. 2.1.2 (4/10/98) - Gave the control panel a cool new look, removed some obsolete options, and touched up the glide feature.
  37.  
  38. 2.1.1 (8/11/97) - Fixed a problem that sometimes caused crashes or unusual operation with the glide feature enabled.
  39.  
  40. 2.1 (8/5/97) – Reworked all the code with CodeWarrior, fixed a compatibility problem with Mac OS 8, made the glide faster and smoother, and squashed a couple of obscure little bugs. Also switched to using the Kagi registration service & added the online registration button.
  41.  
  42. 2.0.1 (8/25/93) – Fixed a problem with Now Utilities. (Oops.)
  43.  
  44. 2.0 (8/24/93) – Original Release of control panel version.
  45.  
  46. 1.0 (5/17/93) – Original Release of extension version.
  47.  
  48. • Troubleshooting: General
  49.  
  50. Snap-To has been thoroughly tested with many Macintoshes and various versions of the System Software, and its performance has been proven. However, There are three known problems that you may experience while using Snap-To. (These aren’t here to scare you, but rather are included in an attempt to inform you about conditions that you may have questions about. In matter of fact, Snap-To works flawlessly with the vast majority of dialog boxes.)
  51.  
  52. 1)
  53.  
  54. What happens: Snap-To seems not to work. When a dialog comes up on the screen, the cursor stays put.
  55.  
  56. Examples: Many parts of the America Online software, Microsoft Applications.
  57.  
  58. Why this happens: The program you are currently running deals with dialog boxes itself, instead of using Apple’s toolbox routines for dialogs. As far as the System (and Snap-To) knows, there is a window on the screen. That’s it. It doesn’t know that it’s a dialog with a default button, or anything. What happens is that Snap-To is informed that a window has been opened. Not being made aware that it’s a dialog, it assumes that it’s an ordinary window with buttons, and doesn’t move the pointer anywhere.
  59.  
  60. There is another instance in which this would occur, in a program that fools around with buttons a lot, such as StuffIt Expander 3.0. In this case, Snap-To is told that the button is somewhere under your desk. (Well, at least not on your screen.) In this case, Snap-To 1.0 tried to snap the cursor to this off-screen point, and finding itself unable to, snapped it to the closest edge of the screen. Snap-To version 2 is smart enough to realize that the button is outside of your dialog, and doesn’t snap the cursor anywhere.
  61.  
  62. 2)
  63.  
  64. What happens: A dialog appears that has no default button. Snap-To snaps the cursor to a button anyway.
  65.  
  66. Example: Various windows in ZTerm.
  67.  
  68. Why this happens: The System does not draw the outline around the default button. This is up to the program that puts up the dialog. Since the System has no way of knowing whether an outline has been drawn around a button or not, it simply assumes that any button with an ID of 1 is the default button, unless the program tells it otherwise. The program is also responsible for telling the System whether or not the window is a dialog. In this case, Snap-To sees a “dialog” in which there is a button with an ID of 1, so it assumes, along with the System, that it is the default button.
  69.  
  70. 3)
  71.  
  72. What happens: Snap-To snaps the cursor to a button that isn’t the default button.
  73.  
  74. Why this happens: The dialog that this occurs on is using a button whose ID is not 1 as the default button, and it isn’t telling the System about it. According to the rules in Inside Macintosh, applications are allowed to use buttons with IDs other than 1 as default buttons, but they must tell the System about it. As Snap-To will ask the System what the ID of the default button is, programs which do this but do not inform the System will exhibit this behaviour.
  75.  
  76. • Troubleshooting: Incompatibilities
  77.  
  78. There are two known incompatibilities caused by Snap-To.
  79.  
  80. 1)
  81.  
  82. What happens: Snap-To doesn’t work in any dialogs at all.
  83.  
  84. Possible cause: Dialog box coloring is active in Greg’s Buttons 3.0.
  85.  
  86. Why this happens: One of the “features” of dialog box coloring is a different dialog box outline. Unfortunately, this outline is the “disabled” outline. Before doing any cursor moving, Snap-To makes sure that the dialog it is working with is enabled, to prevent snapping to dialogs in the background. If it is not active, no cursor movement takes place.
  87.  
  88. Workaround: Disable dialog box coloring in Greg’s Buttons, or downgrade to Snap-To 1.0. All other features of Greg’s Buttons do not interfere with either version of Snap-To.
  89.  
  90. 2)
  91.  
  92. What happens: Snap-To crashes at startup, or something equally hideous.
  93.  
  94. Possible cause: You are running a System prior to version 7.
  95.  
  96. Why this happens: Snap-To relies on resources which are only available in System 7 and above.
  97.  
  98. Workaround: Upgrade to System 7 or above, or downgrade to Snap-To 2.0.
  99.  
  100. • Acknowledgements
  101.  
  102. Inspired by the Microsoft Mouse Driver 9.0.
  103. Thanks to Shane Looker for releasing the source code for the “Annoyance Pack,” Judd Stiff for his invaluable help in beta testing during my formative years, and everybody else who helped me out along the way!
  104.